home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #5 & #6 / Amiga Plus CD - 1995 - No. 5 and 6.iso / tex / man / bm2font.doc < prev    next >
Text File  |  1993-01-19  |  5KB  |  139 lines
  1. This is bm2font, a utility to convert pictures into TeX fonts, in C.
  2.  
  3.  
  4. This is the C port of the Pascal program of the same name by
  5. Friedhelm Sowa <tex@tex@dd0rud81.bitnet>
  6.  
  7. It has been converted to C via p2c, the Pascal-to-C converter written
  8. by  Dave Gillespie, <synaptx!daveg@uunet.UU.NET>
  9. and is  up and running on NeXT, sun sparc (gcc) and rs6000 (gcc).
  10. For these three I provided cc lines in the Makefile
  11.  
  12. New in the list is Mach I386 whatever this means
  13.  
  14. ------------------------------------------------------------------------------
  15. Amiga port & correct iff-support has been done by Steffen Gutmann 1993. 
  16. (Questions about the Amiga version send to gutmann@informatik.uni-ulm.de)
  17. You don't need to compile anything, since there already exists an executable
  18. bm2font in this archive. 
  19. Iff pictures must have the suffix .lbm or .iff in the filename.
  20. ------------------------------------------------------------------------------
  21.  
  22. Manifest:
  23. ========
  24.  
  25. You should have obtained bm2font.c, p2clib.c, loc.p2clib.c, p2c.h,
  26. and a Makefile.
  27. And the Gnu Public licence.
  28.  
  29. There is a subdirectory "testpix" now, containing a selection of
  30. pictures, some of them out of Friedhelm's manual, by the author's
  31. permission, some others of my own choice, where you might experiment
  32. the different settings (particularly "carina" is extremely difficult!)
  33. and a selection of grayscales for testing.
  34.  
  35.  
  36. Changes against the PC version:
  37. ==============================
  38.  
  39. I took out the preview option (-s) and the pxl file option (-p)
  40. The former has been most PC specific, and would have to be
  41. handled by a bunch of library functions, and for the latter
  42. I don't see a real need today anymore (If you are still hooked,
  43. complain to your dope dealers)
  44. and I removed the interpretation of environment variables, which would
  45. make little sense in a Unix environment.
  46. So everything is handled locally, even if you call
  47. bm2font /pub/gifs/dobie.gif
  48. you will obtain ./dobiea.tfm, ./dobiea.300pk etc.
  49. (and see a fake)
  50. (NeXT and Sony addicts: I left it at 300 by default)
  51.  
  52.  
  53. Tiff Users Attention please 
  54. ===========================
  55.  
  56. There seems to be some babel going on around the name "tiff".
  57. I had the opportunity to try out tifflib and SDSClib
  58. on tiffs, and found out that the current scanner software
  59. on PCs, as well as the examples talk a language entirely
  60. uncomprehensible to them and vice versa.
  61.  
  62. So, if you have tiffs from, say, the Peoples collection, or some
  63. Icon, do convert it to gif before applying bm2font. There is
  64. enough of software ready to do the conversion. Try pbmplus.
  65.  
  66.  
  67.  
  68. Compilation notes:
  69. =================
  70.  
  71. The p2c stuff is intended to go with bm2font since they are modifications
  72. made while mating bm2font to p2c. Mille gracias to Dave for valuable
  73. suggestions.
  74.  
  75. Do not put them into your installed p2c-version, nor replace
  76. them by your installed p2c versions.
  77.  
  78. The sample CC lines that are in the Makefile may fail for you;
  79. the gccs I used may not be the same for you, nor the OS.
  80.  
  81. The defines mentioned in the Makefile refer to entries in p2c.h,
  82. except one: -DINTEL which refers to order of significance stuff
  83. inside bm2font. Set that for intel machines.
  84. For the other defines, try p2c.h for reference.
  85.  
  86. In particular, I know nothing about SysV-systems, so, try your luck.
  87.  
  88.  
  89. Manual:
  90. ======
  91.  
  92. There is no bm2font.1 yet, I do not speak troff.
  93.  
  94. Friedhelm's manual applies to this version, except the changes
  95. mentioned above.
  96. I won't bundle it with this package since it is readily available
  97. on all TeX servers.
  98.  
  99. For printing the manual, you must give to the supplied pks the extension
  100. *.300pk.
  101.  
  102. Note to NeXT and Sony users: For printing the manual, you must give your
  103. dvi-printer the resolution 300. Sony will print it in smallprint,
  104. NeXT built-in PS interpreter scales it up again (and does a
  105. real good job, at that)
  106.  
  107.  
  108. Thanks to:
  109. =========
  110.  
  111. Friedhelm Sowa, who constantly kept me posted to the latest updates
  112. and things yet to do. He was the one to point out that the INTEL switch
  113. was to be a cpp define switch instead a web switch.
  114.  
  115. Dave Gillespie, the author of p2c, who suggested a good many changes
  116. to p2c instead of the fixes I did..
  117.  
  118. Bart Childs and Heinz Werntges who were the first guinea pigs to
  119. test this out
  120.  
  121.  
  122. ===========================================
  123. Well, erh, there are the copyright notices:
  124.  
  125. bm2font is (C) 1991, 1992 by Friedhelm Sowa,
  126. p2c.h, p2clib.c, loc.p2clib.c is
  127.    (C) 1989, 1990, 1991  Free Software Foundation, Inc.
  128. and the Unix port is (A) by mahilata (All Rights Destroyed)
  129.  
  130. ..and
  131. #include <stddisclaim.h>
  132. Specifically, I do not guarantee that you will be able to print
  133. the Kascha series out of a.s.p--I did not keep them for testing:-)
  134. (Really, to me the lyaps out of Northern Norway are more exciting stuff,
  135.  but, perhaps I am a pervert)
  136.  
  137. All complaints please direct to mahilata@vogon.mathi.uni-heidelberg.de
  138. who will most gladly pipe them to /dev/null
  139.